home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 1 / CU Amiga Magazine CD-ROM Special Edition (1995)(EMAP Images)(GB)[Issue 1995-11].iso / Aminet / comm / mail / AirMail.lha / AirMail / AM_EditorScript.lha / editor.doc next >
Text File  |  1995-06-07  |  4KB  |  128 lines
  1. editor.rexx - Introduction
  2. --------------------------
  3.  
  4. Editor.rexx is a script for Airmail to allow you to use 
  5. an external editor and pager without headaches.  If you
  6. were to just enter the name of your favorite editor
  7. into Airmail, you might be dismayed to find that
  8. whenever you wanted to just read a mail it ends up in
  9. that editor.  No more...
  10.  
  11. Requirements
  12. ------------
  13.  
  14. Airmail
  15. Arexx
  16. rexxreqtools.library
  17. reqtools.library
  18.  
  19. Installation
  20. ------------
  21.  
  22. Installation is as simple as setting the "External Editor"
  23. field in Airmail's Mailbox Configuration window to
  24. rx + the path of the script.  For example, on
  25. my system, the external editor is set to:
  26.  
  27. dh0:rexxc/rx dh2:AirMail/editor.rexx
  28.  
  29. Note that the actual device names and not the logical 
  30. assigns must be specified - this according to the 
  31. documentation of Airmail.
  32.  
  33. Now, you will need to set two environment variables, easily
  34. done in s:user-startup
  35.  
  36. AIREDITOR = the full pathname of your editor
  37. AIRPAGER = the full pathname of your pager
  38.  
  39. For example, in user-startup you could put
  40.  
  41. setenv AIRPAGER "sys:utilities/most"
  42. setenv AIREDITOR "c:ed"
  43.  
  44. Now, you must insure that the libraries that editor.rexx
  45. requires are in libs:  If "rexxreqtools.library" and 
  46. "reqtools.library" are not present in your libs:
  47. directory, you cannot use the script.  
  48.  
  49. Should you need these libraries they are available on the
  50. Aminet under:
  51.  
  52. ReqTools22c_us.lha   util/libs  176K+ReqTools 2.2c - the requester toolkit
  53. RexxReqTools.lha     util/rexx   65K+1.3 - requester for ARexx 
  54.  
  55. A good Aminet site to try is ftp.netnet.net /pub/aminet ...
  56.  
  57. Usage
  58. -----
  59.  
  60. Using editor.rexx is simple - just follow the instructions in the prompts 
  61. the script gives.  Using the script runs something like this:
  62.  
  63. Click "Read" in Airmail ... the script launches the pager defined
  64. in AIRPAGER to read the mail.
  65.  
  66. Click "Reply" in Airmail ... the script launches your editor.  After you're
  67. done saying your piece, save and quit from the editor.  You will then be
  68. presented with a requester with header information and several change 
  69. buttons - use these to change any headers you like. Some special notes:
  70.  
  71. |"Attachment" - brings up a file requester for you to select a file to 
  72. | attach to the end of your mail.
  73.  
  74. |"Abort Mail" - Don't queue your mail for sending ... get rid of it 
  75. | permanently.
  76.  
  77. |"Queue Mail" - Saves the mail in your outbox for sending whenever you 
  78. | like.
  79.  
  80. Select "Edit Signature" in the Airmail menus - the script will bring up
  81. your editor on your sig file.  Save and quit when you're done.
  82.  
  83. WARNING - READ THIS!!!
  84. ----------------------
  85.  
  86. Although Airmail supports asynchronous editing - i.e. editing multiple
  87. files or reading one file while editing another and this support is 
  88. also implemented in the script, doing so is a risky business.  When it
  89. works it works beautifully.  When it doesn't, Airmail may crash HARD and 
  90. take your hard drive partition with it!!! (As it did mine - luckily I have
  91. network utilities on a small easy-to-backup partition) 
  92.  
  93. The best policy is to just do one thing at a time for now.
  94.  
  95. (Last updated 6-7-95 with Airmail Beta 7)
  96.  
  97. Disclaimer
  98. ----------
  99.  
  100. The author of this script is in no way responsible for any damages resulting
  101. from its proper or improper use.  I.e., this script is free so use it at
  102. your own risk.
  103.  
  104. Distribution
  105. ------------
  106.  
  107. Freely distributable, although I ask that you send me any improvements you
  108. might make.  Those who have seen modhdr.rexx have seen this before... :)
  109.  
  110. Author Information
  111. ------------------
  112.  
  113. This Arexx script was written by Rick Taylor, reachable as:
  114.  
  115. charlet@hubcap.clemson.edu
  116.  
  117. Or, on the web,
  118.  
  119. http://www.clemson.edu/~charlet/
  120.  
  121. Bug reports, questions, Heath bars, large sums of money in small easy to
  122. carry sacks, etc. go there.  Flames go to NIL:
  123.  
  124. * This script is based on modhdr.rexx for the freeware version of GRn.
  125.   Modhdr.rexx is also on Aminet.
  126.  
  127. modhdr.lha           comm/news    4K+Script for GRn ... adds some reqtools st
  128.